package cn.iocoder.yudao.module.digital.service.patent;

import java.util.*;
import jakarta.validation.*;
import cn.iocoder.yudao.module.digital.controller.admin.patent.vo.*;
import cn.iocoder.yudao.module.digital.dal.dataobject.patent.PatentDO;
import cn.iocoder.yudao.module.patent.dal.dataobject.authors.AuthorsDO;
import cn.iocoder.yudao.framework.common.pojo.PageResult;
import cn.iocoder.yudao.framework.common.pojo.PageParam;

/**
 * 专利信息 Service 接口
 *
 * @author admin
 */
public interface PatentService {

    /**
     * 创建专利信息
     *
     * @param createReqVO 创建信息
     * @return 编号
     */
    Integer createPatent(@Valid PatentSaveReqVO createReqVO);

    /**
     * 更新专利信息
     *
     * @param updateReqVO 更新信息
     */
    void updatePatent(@Valid PatentSaveReqVO updateReqVO);

    /**
     * 删除专利信息
     *
     * @param id 编号
     */
    void deletePatent(Integer id);

    /**
     * 获得专利信息
     *
     * @param id 编号
     * @return 专利信息
     */
    PatentDO getPatent(Integer id);

    /**
     * 获得专利信息分页
     *
     * @param pageReqVO 分页查询
     * @return 专利信息分页
     */
    PageResult<PatentDO> getPatentPage(PatentPageReqVO pageReqVO);

    // ==================== 子表（专利作者信息） ====================

    /**
     * 获得专利作者信息列表
     *
     * @param patentId 关联的专利ID，不使用外键关联
     * @return 专利作者信息列表
     */
    List<AuthorsDO> getAuthorsListByPatentId(Integer patentId);

}